home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmQTspecifyRenderTable.z / XmQTspecifyRenderTable
Text File  |  1998-10-30  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmQQQQTTTTssssppppeeeecccciiiiffffyyyyRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmQQQQTTTTssssppppeeeecccciiiiffffyyyyRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e - A widget holding this trait can
  10.           supply the names of its default render tables to any
  11.           requestor
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           #include <Xm/SpecRenderT.h>
  15.  
  16.           typedef struct {
  17.                     int                             version;
  18.                     XmSpecRenderGetTableProc        getRenderTable;
  19.           } XmSpecRenderTraitRec, *XmSpecRenderTrait;
  20.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee ((((****XXXXmmmmSSSSppppeeeeccccRRRReeeennnnddddeeeerrrrGGGGeeeettttTTTTaaaabbbblllleeeePPPPrrrroooocccc))))(
  21.           WWWWiiiiddddggggeeeetttt,
  22.           XXXXttttEEEEnnnnuuuummmm);
  23.  
  24.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  25.           This page documents Motif 2.1.
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.           A widget holding the _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait is
  29.           responsible for providing a requestor with a suitable render
  30.           table.  Any manager widget holding this trait should provide
  31.           the following three resources:
  32.  
  33.              +o  A resource to hold the label render table
  34.  
  35.              +o  A resource to hold the button render table
  36.  
  37.              +o  A resource to hold the text render table
  38.  
  39.           The ggggeeeettttRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee trait method of
  40.           _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_ewill use the values of the three
  41.           resources as the basis for its returned information.
  42.  
  43.           The _X_m_Q_T_s_p_e_c_i_f_y_R_e_n_d_e_r_T_a_b_l_e trait is somewhat unusual in that
  44.           other widgets do not access its trait method through the
  45.           usual trait mechanisms.  Instead, other widgets access the
  46.           ggggeeeettttRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee trait method by calling
  47.           XXXXmmmmeeeeGGGGeeeettttDDDDeeeeffffaaaauuuullllttttRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee.
  48.  
  49.           The following standard Motif widgets hold this trait:
  50.  
  51.              +o  XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd and all its subclasses
  52.  
  53.              +o  _X_m_V_e_n_d_o_r_S_h_e_l_l and all its subclasses
  54.  
  55.              +o  XXXXmmmmMMMMeeeennnnuuuuSSSShhhheeeellllllll
  56.  
  57.           The _E_x_m_G_r_i_d demonstration widget also installs this trait.
  58.  
  59.         TTTThhhheeee ggggeeeettttRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee TTTTrrrraaaaiiiitttt MMMMeeeetttthhhhoooodddd
  60.  
  61.  
  62.  
  63.      PPPPaaaaggggeeee 1111                                         ((((pppprrrriiiinnnntttteeeedddd 11110000////22224444////99998888))))
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmQQQQTTTTssssppppeeeecccciiiiffffyyyyRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVVXXXXmmmmQQQQTTTTssssppppeeeecccciiiiffffyyyyRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee ggggeeeettttRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(
  75.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  76.           XXXXttttEEEEnnnnuuuummmm rrrreeeennnnddddeeeerrrrTTTTaaaabbbblllleeeeTTTTyyyyppppeeee);
  77.  
  78.           The ggggeeeettttRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee trait method returns a render table
  79.           corresponding to the _r_e_n_d_e_r_T_a_b_l_e_T_y_p_e of widget _w_i_d_g_e_t.  This
  80.           value (if non-NULL) is the internal value of the manager's
  81.           render table, and should not be modified or freed.
  82.  
  83.           For example, given a manager widget named
  84.           MMMMyyyyMMMMaaaannnnaaaaggggeeeerrrrWWWWiiiiddddggggeeeettttthat supports the correct render table
  85.           resources, the following is a sample implementation of the
  86.           trait method:
  87.  
  88.           static XmRenderTable
  89.           GetRenderTable( Widget widget,
  90.                           XtEnum renderTableType)
  91.           {
  92.           XmMyManagerWidget mm = (XmMyManagerWidget) widget;
  93.            switch(renderTableType) {
  94.              case XmLABEL_RENDER_TABLE: return mm->my_manager.label_render_table;
  95.              case XmBUTTON_RENDER_TABLE: return mm->my_manager.button_render_table;
  96.              case XmTEXT_RENDER__RENDER_TABLE: return mm->my_manager.text_render_table;
  97.            }
  98.            return NULL;
  99.           }
  100.  
  101.           _w_i_d_g_e_t    Specifies the widget containing render table
  102.                     information.
  103.  
  104.           _r_e_n_d_e_r_T_a_b_l_e_T_y_p_e
  105.                     Specifies the desired type of render table; the
  106.                     specified value must be one of the following:
  107.                     XXXXmmmmLLLLAAAABBBBEEEELLLL____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE, XXXXmmmmBBBBUUUUTTTTTTTTOOOONNNN____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE, and
  108.                     XXXXmmmmTTTTEEEEXXXXTTTT____RRRREEEENNNNDDDDEEEERRRR____TTTTAAAABBBBLLLLEEEE.
  109.  
  110.      RRRREEEELLLLAAAATTTTEEEEDDDD
  111.           XXXXmmmmBBBBuuuulllllllleeeettttiiiinnnnBBBBooooaaaarrrrdddd(3), VVVVeeeennnnddddoooorrrrSSSShhhheeeellllllll(3), XXXXmmmmMMMMeeeennnnuuuuSSSShhhheeeellllllll(3), and
  112.           XXXXmmmmeeeeGGGGeeeettttDDDDeeeeffffaaaauuuullllttttRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee(3).
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.